home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 October / Chip_2004-10_cd1.bin / software / stahuj / prog / pdfdemo.exe / {app} / readme.txt < prev    next >
Text File  |  2004-04-30  |  5KB  |  116 lines
  1. PDF File Creator by FyTek, Inc.
  2. http://www.fytek.com
  3.  
  4. The demo is good for 30 days.  After that time you'll need to purchase a
  5. copy or download a new demo.
  6.  
  7. Executable Version
  8. ------------------
  9. Syntax: pdffile.exe filein fileout [options]
  10.  
  11.         OR
  12.         
  13.         pdffile.exe source_directory [target_directory] [options]
  14.         -?              - prints this list of options
  15.         -ver            - prints the current version
  16.         -v              - verbose mode
  17.         -open           - open Acrobat with the newly created PDF
  18.         -print          - print the newly created PDF
  19.         -o              - set owner password
  20.         -u              - set user password
  21.         -noprint        - do not allow user to print
  22.         -nochange       - do not allow user to change
  23.         -nocopy         - do not allow user to copy text/graphics
  24.         -noannote       - do not allow user to add/update annotations
  25.         -e128           - use 128-bit encryption (Acrobat 5.0 and up)
  26.         -s              - include subdirectories
  27.         -f              - flat-file parameters (see the documentation)
  28.         -b              - keep current line breaks
  29.         -p              - print page numbers
  30.         -nw             - no wrap
  31.         -t type         - file type to match (i.e. *.rpt)
  32.  
  33. See the documentation for more information on these options.
  34.  
  35. The program will convert plain ascii files into pdf if you don't use the
  36. command language.  You can use the -f and -nw options to convert legacy (green
  37. bar) type reports into pdf.  Use a courier font for best results when using
  38. this method since the characters are fixed spaced.
  39.  
  40. Also, you can convert just plain text using the -f and the -b options.  This
  41. method would work well on this readme.txt file for instance.  With either
  42. method you can use "in-line" commands.  These are commands to change the font,
  43. do highlighting, underlining or even add web links.  They are HTML like and
  44. are described in the documentation.
  45.  
  46. To really have the most control over your where things are placed in your PDF,
  47. you'll want to use the command language.  This is what the tool was originally
  48. designed for.  Very precise control over text and line placement, like on a
  49. tax form.  The idea is to make setting up a complex form like that relatively
  50. easy.  By building your commands off of database information you can create
  51. PDFs on-the-fly over the web.  Or just create them for e-mailing.
  52.  
  53. Start by looking at the sample reports included to begin learning how the
  54. command language works.  It's fairly easy to get started and you'll find that
  55. you can get quite creative.
  56.  
  57. To convert a report run:
  58. pdffile.exe company.rpt company.pdf
  59.  
  60. Windows DLL
  61. -----------
  62. For Visual Basic, go to the Project:References dialog and add the reference to
  63. buildPDF. See the sample application and the documentation for information on
  64. using.
  65.  
  66. Some methods of build.PDF:
  67.  
  68. setInFile     - Sets the input file (or leave blank and use setPDFCmd).
  69. setOutfile    - Sets the output file (or leave blank to have the PDF commands returned to
  70.                 your program).
  71. setPDFCmd     - Commands to execute (when not using an input file).  Call this method for 
  72.                 each command.
  73. setOpen       - Opens Acrobat with the newly created PDF
  74. setPrint      - Prints the newly created PDF
  75. setMail       - Opens an e-mail window with the newly created PDF attached
  76. setOwner      - Sets the owner password
  77. setUser       - Sets the user password
  78. setNoPrint    - Disables printing
  79. setNoCopy     - Disables copying of text/graphics
  80. setNoChange   - Disables changes to document
  81. setNoAnnote   - Disables changes to annotations
  82. setEncrypt128 - Use 128-bit encryption (Acrobat 5.0 and up)
  83. buildPDF      - Command to create the PDF.
  84.  
  85. Flat file methods can be found in the pdfdll.pdf document.
  86. There is a sample VB program included.
  87.  
  88. See the documentation for more information on these options.
  89.  
  90. Using the .NET DLL
  91. ------------------
  92. The file dotnet.cs shows how to use the .NET DLL with a C# program.
  93. You'll need the .NET redistributable or SDK installed (available
  94. from Microsoft) in order to use this version.
  95. Compile dotnet.cs by running:
  96. csc -nologo dotnet.cs -r:pdffiledn.dll
  97.  
  98. The main components are:
  99. pdffiledn.dll    - The .NET DLL version    (this is a .NET dll)
  100. perlrt.dll     - Needed for the .NET DLL (this is a .NET dll)
  101. perlnh.dll     - Needed for the .NET DLL (this is a standard dll)
  102.  
  103. The methods for the .NET DLL are the same as those for the standard DLL.
  104.  
  105. You can add pdffiledn.dll and perlrt.dll to the global assembly cache by
  106. running the following:
  107. gacutil.exe -i perlrt.dll
  108. gacutil.exe -i pdffiledn.dll
  109.  
  110. You might need to copy perlnh.dll into the bin directory for web (ASP)
  111. applications.  pdffiledn.dll will be looking for it when it executes.
  112.  
  113. You will need a copy of Acrobat to view your output.  You can get a free copy
  114. at:
  115. http://www.adobe.com/products/acrobat/readstep.html
  116.